Inside Macintosh: QuickDraw GX Graphics /

Chapter 2 - Geometric Shapes / Geometric Shapes Reference

Functions / Getting and Setting Shape Geometries

GXGetCurve

You can use the GXGetCurve function to determine the geometry of an existing curve shape.

gxCurve *GXGetCurve(gxShape source, gxCurve *data);

source

A reference to the curve shape whose geometry you want to determine.

data

A pointer to a gxCurve structure. The function copies the source shape's geometry into this structure.

function result

A pointer to a copy of the source shape's geometry.

DESCRIPTION

The GXGetCurve function copies the geometry information from the source curve shape into the gxCurve structure pointed to by the data parameter. As a convenience, this function also returns a pointer to the curve geometry as the function result.

If the source shape is not a curve shape, this function posts the error code illegal_type_for_shape.

You must pass a pointer to a gxCurve structure in the data parameter--if you pass nil for this parameter, the function posts the error code parameter_is_nil.

ERRORS, WARNINGS, AND NOTICES

Errors
out_of_memory
shape_is_nil
illegal_type_for_shape	(debugging version)
parameter_is_nil	(debugging version)

SEE ALSO

For general information about curve geometries, see "Curve Shapes" on page 2-18.

For the definition of the gxCurve structure, see page 2-105.

To create a new curve shape, use the GXNewCurve function, which is described on page 2-113.

To change the geometry of an existing curve shape, use the GXSetCurve function, which is described in the next section.

To draw a curve geometry without creating a curve shape object, use the GXDrawCurve function, which is described on page 2-159. To draw a curve shape, use the GXDrawShape function, which is described in the chapter "Shape Objects" in Inside Macintosh: QuickDraw GX Objects.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help